Microsoft DirectX 8.1 (C++)

RenderEngine.GetGroupOutputPin Method

The RenderEngine.GetGroupOutputPin method retrieves the output pin for the specified group.

Syntax

object.GetGroupOutputPin(
    Group As Long,
    ppRenderPin As IPin
)

Parameters

Group

Zero-based index that specifies the group.

ppRenderPin

The IPin object that receives the output pin.

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

Value Description
E_INVALIDARG Invalid argument.
E_MUST_INIT_RENDERER Render engine failed to initialize.
E_RENDER_ENGINE_IS_BROKEN Operation failed because project was not rendered successfully.
E_UNEXPECTED Unexpected error.

Remarks

Before calling this method, call ConnectFrontEnd to build the front end of the graph. Each group represents a single media stream, and the front end has a corresponding output pin.

You can use this method to create the rendering portion of a file-writing graph. Connect the output pins to multiplexer filters and file writer filters. For more information, see Rendering a Project.

For preview, you don't need to call this method. Just call ConnectFrontEnd followed by RenderOutputPins.

See Also